home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr44 / sndoff20.zip / MUSIC.DOC < prev    next >
Text File  |  1993-04-07  |  6KB  |  119 lines
  1.                                   MUSIC.DOC
  2.  
  3.                        Playing The Sound Off! SOM Files
  4.                               Concept and Format
  5.  
  6.  
  7.   This file is a supplement to the SOUNDOFF.DOC Program Manual.
  8.   Rather than totally rewrite and reformat the Manual, I decided this
  9.   would be easier. Also, the Music capability of Sound Off! is more
  10.   complex than the other functions, and with this seperate DOC, you
  11.   dont have to thumb through all the other stuff for reference.
  12.  
  13.  
  14.   This manual will attempt to give you a little insight into the procedure
  15.   and format of creating a *.SOM file, which is a script file of Music for
  16.   Sound Off! to play on command.
  17.  
  18.   Sound Off! reads and plays music in basically the same format as BASICA
  19.   using the PLAY command.
  20.  
  21.   I suggest you view the supplied *.SOM files with your text viewer or editor
  22.   to see how they are written. These, along with this manual should get you
  23.   going in the right direction for making your PC play anything from
  24.   "Twinkle Twinkle Little Star" to a 30 min Bach symphony piece.
  25.  
  26.   Unfortunatley, I am not a music writing expert....though I have, and still
  27.   do, play music professionaly, I can't read or write a note! So my help is
  28.   really only going to be that of telling you how the process works.
  29.  
  30.   A simple description is....Sound Off! reads charecters from the script and
  31.   converts them into a numeric value, which is played throught the PC
  32.   speaker. Certain charecters, such as (#) and (.) are interpeted in a
  33.   special way, as are a few others that instruct the program on timing,
  34.   pausing, playing speed etc. You can type most anything in a .SOM script and
  35.   Sound Off! will make some music from it, run the script GARBAGE.SOM through
  36.   Sound Off! and see what I mean. Problem is, without being structered
  37.   properly, the "music" won't make much sense!
  38.  
  39.   SCRIPT FILES:
  40.  
  41.     Your script files must be saved with an extension of (.SOM), when you
  42.     specify the file for Sound Off! to play with the /m or /ms switch, you
  43.     need not specify the extension, it is assumed, and therefore required to
  44.     be of the proper syntax. Sound Off! first searches the current directory,
  45.     then all directories in the PATH statement for the specified file. If the
  46.     script resides in a directory NOT in the PATH, or on a floppy, then you
  47.     may specify drive and directory with the filename.
  48.  
  49.     Examples:   SOUNDOFF /m WillTell = plays the WILLTELL.SOM script file
  50.     that resides either in the current directory or in a PATH directory.
  51.                 SOUNDOFF /m A:\BACH23 = plays the BACH23.SOM that is on the
  52.                 floppy in the A: Drive.
  53.  
  54.     If you are playing a .SOM script from within a batch file, using the /ms
  55.     switch will turn off Sound Off! displays.
  56.  
  57.     By the way...if you have not figured it out yet, the extensions for Sound
  58.     Off! script files stand for the following:
  59.  
  60.     .SOM = Sound Off! MUSIC script
  61.     .SOS = Sound Off! SOUND script.
  62.  
  63.     The following page(s) list and somewhat explain the music file structure
  64.     and commands for Sound Off! music.
  65.  
  66.  
  67.    Sound Off! interprets a string very similar to that used with the
  68.    PLAY verb in BASICA.  The two major exceptions are that the "N" order
  69.    is not interpreted and that variables cannot appear in the string.
  70.  
  71.       The string characters are interpreted as follows:
  72.  
  73.       A .. G    The musical notes A thru G.  A note may be followed
  74.                 by an accidental ('#' or '+' for sharp and '-' for
  75.                 flat.)  Additionally, a note (With optional sharp or
  76.                 flat) may also be followed by a number denoting the
  77.                 note length (1 for a whole note thru 64 for a 64th
  78.                 note.)   The note, with optional accidental and
  79.                 length, may also be followed by one or more dots
  80.                 ("."), each of which extends the note by one half
  81.                 of its existing value.  For example, two dots produce
  82.                 a length of 9/4 the original value, and three dots
  83.                 a length of 27/8 the original value.
  84.  
  85.       Ln        Specifies the default length of the notes following
  86.                 ("n" must be 1 for a whole note thru 64 for a 64th
  87.                 note.)  The initial default value is 4 (quarter note.)
  88.  
  89.       Mz        Specifies the fraction of the note length that the
  90.                 note is actually sounding.  "z" is one of the letters
  91.                 "S", "N", or "L", which have these meanings:
  92.  
  93.                    MS   Music staccato   (3/4 of note length)
  94.                    MN   Music normal     (7/8 of note length)
  95.                    ML   Music legato     (all of note length)
  96.  
  97.       On        Specifies the octave in which the notes following
  98.                 are to be played (0 thru 7).  The initial default
  99.                 octave is 3, which is the octave which begins at
  100.                 middle C.
  101.  
  102.       Pn        Specifies that no sound is to be made for an
  103.                 interval.  "n" (optional) is the note length (1
  104.                 for a whole note thru 64 for a 64th note.)  If "n"
  105.                 is omitted, the current default note length is used.
  106.                 One or more dots may follow, each of which extends
  107.                 the rest by one half of its existing value.
  108.  
  109.       Tn        Specifies the tempo in beats per minute (32 thru
  110.                 255.)  The initial default value is 120.
  111.  
  112.    Thats about all I can give you, you're on your own. If you have played
  113.    with BASICA or QBASIC, you should have no trouble making Beautiful Music.
  114.    If this is new to you, well....experimenting, trial and error, are two of
  115.    the BEST teachers known to man.
  116.  
  117.    ENJOY!
  118.  
  119.